WHAT DOES THIS DO?

It basically adds a new listener for when the settings change in the frontend, not just when they're updated. This way you can resend a new set of settings to the frontend to render.

EDIT: Changed naming from on_chat_settings_edit > on_settings_edit for the sake of readability on a forced push.

Code example:

@cl.on_settings_edit
async def on_settings_edit(settings):
    provider = settings.get("Provider")
    if provider == "OpenAI":
        models = ["gpt-3.5-turbo", "gpt-4"]
    elif provider == "Anthropic":
        models = ["claude-2", "claude-instant-1"]
    
    # Update the settings widgets dynamically
    await cl.ChatSettings([
        cl.input_widget.Select(id="Provider", label="Provider", values=["OpenAI", "Anthropic"], initial_value=provider),
        cl.input_widget.Select(id="Model", label="Model", values=models)
    ]).send()

POC (in my case, multi-language bible version selection for a personal project)

Note: There might be some changes in the code linting bc of my IDE settings

Summary by cubic

Adds a live chat settings edit listener so the app can react to on-the-fly changes and push updated widgets back to the UI. Implements the settings change listener requested in Linear #1858.

• New Features
  • Backend: new @cl.on_settings_edit decorator; added to CodeSettings; wired via a "chat_settings_edit" socket event (runs in WS context).
  • Frontend: ChatSettings emits "chat_settings_edit" on form changes with a lodash isEqual guard; react-client exposes editChatSettings.
  • Non-breaking: existing on_settings_update remains unchanged.

^{Written for commit 912ed3d. Summary will update on new commits.}